Kodiert ein WString in einen UTF-8 kodierten Bytestrom.
| LGF_EncodeUtf8 (FC) | ||||||||
|---|---|---|---|---|---|---|---|---|
| WString | sourceString | Ret_Val | Word | |||||
| DInt | startPos | bytesUsed | UInt | |||||
| Array[*] of Byte | encodedByteStream | Array[*] of Byte | ||||||
| Bezeichner | Datentyp | Beschreibung |
|---|---|---|
| sourceString | WString | Zeichen, das nach UTF-8 konvertiert werden soll |
| startPos | DInt | Position im Byte Stream, um die encodierten WChars einzufügen (Array Untergrenze wird aufaddiert) |
| Bezeichner | Datentyp | Beschreibung |
|---|---|---|
| Ret_Val | Word | 16#0000 - 16#7FFF: Status des FC, 16#8000 - 16#FFFF: Fehlererkennung |
| bytesUsed | UInt | Anzahl der umgewandelten Bytes. Der Bereich reicht von 1 bis 3. |
| Bezeichner | Datentyp | Beschreibung |
|---|---|---|
| encodedByteStream | Array[*] of Byte | UTF-8-konforme Bytefolge. B0 speichert das erste Byte, B1 das zweite und B2 das dritte Byte. B3 wird nicht verwendet |
| Code / Wert | Bezeichner / Beschreibung |
|---|---|
| 16#0000 | STATUS_NO_ERROR Status: Kein Fehler |
| 16#8201 | ERR_START_POS_OUTSIDE Fehler: Parameter `startPos` liegt außerhalb der Array-Grenzen |
| 16#8202 | ERR_COUNT_EXCEEDS_BOUNDS Fehler: Parameter `count` liegt außerhalb der Array-Grenzen |
| Version & Datum | Änderungsbeschreibung | |
|---|---|---|
| 1.0.0 | Siemens Online Support | |
| 2022-12-16 | First released version | |